home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3g / copylist.z / copylist
Encoding:
Text File  |  2002-10-03  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ccccooooppppyyyylllliiiisssstttt((((3333GGGG))))                                                      ccccooooppppyyyylllliiiisssstttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_oooo_pppp_yyyy_llll_iiii_ssss_tttt - copy a file into memory
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_cccc [_f_l_a_g ...] _f_i_l_e ...  _----_llll_gggg_eeee_nnnn [_l_i_b_r_a_r_y ...]
  13.  
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_gggg_eeee_nnnn_...._hhhh_>>>>
  15.  
  16.      _cccc_hhhh_aaaa_rrrr _****_cccc_oooo_pppp_yyyy_llll_iiii_ssss_tttt _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_f_i_l_e_n_m_,,,, _oooo_ffff_ffff______tttt _****_s_z_p_t_r_))))_;;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _cccc_oooo_pppp_yyyy_llll_iiii_ssss_tttt copies a list of items from a file into freshly allocated
  20.      memory, replacing new-lines with null characters.  It expects two
  21.      arguments: a pointer _f_i_l_e_n_m to the name of the file to be copied, and a
  22.      pointer _s_z_p_t_r to a variable where the size of the file will be stored.
  23.  
  24.      Upon success, _cccc_oooo_pppp_yyyy_llll_iiii_ssss_tttt returns a pointer to the memory allocated.
  25.      Otherwise it returns _NNNN_UUUU_LLLL_LLLL if it has trouble finding the file, calling
  26.      _mmmm_aaaa_llll_llll_oooo_cccc, or opening the file.
  27.  
  28. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  29.      _////_**** _rrrr_eeee_aaaa_dddd _""""_ffff_iiii_llll_eeee_"""" _iiii_nnnn_tttt_oooo _bbbb_uuuu_ffff _****_////
  30.      _oooo_ffff_ffff______tttt _ssss_iiii_zzzz_eeee_;;;;
  31.      _cccc_hhhh_aaaa_rrrr _****_bbbb_uuuu_ffff_;;;;
  32.      _bbbb_uuuu_ffff _==== _cccc_oooo_pppp_yyyy_llll_iiii_ssss_tttt_((((_""""_ffff_iiii_llll_eeee_""""_,,,, _&&&&_ssss_iiii_zzzz_eeee_))))_;;;;
  33.      _ffff_oooo_rrrr _((((_iiii _==== _0000_;;;; _iiii _<<<< _ssss_iiii_zzzz_eeee_;;;; _iiii_++++_++++_))))
  34.           _iiii_ffff_((((_bbbb_uuuu_ffff_[[[[_iiii_]]]]_))))
  35.                _pppp_uuuu_tttt_cccc_hhhh_aaaa_rrrr_((((_bbbb_uuuu_ffff_[[[[_iiii_]]]]_))))_;;;;
  36.           _eeee_llll_ssss_eeee
  37.                _pppp_uuuu_tttt_cccc_hhhh_aaaa_rrrr_((((_''''_\\\\_nnnn_''''_))))_;;;;
  38.  
  39. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  40.      _mmmm_aaaa_llll_llll_oooo_cccc(3C)
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.